treeview: Update the description format

expression: Update docs format

And add documentation stanzas for GtkExpression sub-types.

Box GtkExpressionWatch

Otherwise bindings won't know how to deal with memory management.

csssection: Update docs syntax

application: Convert docs

Drop mentions of command line arguments parsed by gtk_init(), and of the
GDK lock.

docs: Fix property annotation

spinbutton: Convert docs

Change link syntax, add an example image, generally clean things up.

searchentry: Convert docs

Change link syntax, add an example image, generally clean things up.

passwordentry: Convert docs

Change link syntax, add an example image, generally clean things up.

editablelabel: Convert docs

Change link syntax, add an example image, generally clean things up.

constrainttarget: Convert docs

buildable: Convert docs

Change link syntax.

accessible: Convert docs

Change link syntax.

widget: Convert docs

Some work toward converting the docs to markdown.

More work needed, in particular around vfuncs and
class functions.

entry: Convert docs

Change link syntax, add an example image, generally clean things up.

switch: Convert docs

Change link syntax, add an example image, generally clean things up.

volumebutton: Convert docs

Change link syntax, add an example image, generally clean things up.

fontbutton: Convert docs

Change link syntax, add an example image, generally clean things up.

colorbutton: Convert docs

Change link syntax, add an example image, generally clean things up.

dropdown: Convert docs

Change link syntax, add an example image, generally clean things up.

appchooserbutton: Convert docs

Change link syntax, add an example image, generally clean things up.

lockbutton: Convert docs

Change link syntax, add an example image, generally clean things up.

comboboxtext: Convert docs

Change link syntax, add an example image, generally clean things up.

combobox: Convert docs

Change link syntax, add an example image, generally clean things up.

docs: Remove duplicate documentation stanzas

docs: Fix typos

docs: Fix value annotation

Drop the `:`.

docs: Fix copy-paste error in GdkDevice

docs: Fix the MenuButton direction property links

menubutton: Convert docs

Change link syntax, add an example image, generally clean things up.

checkbutton: Convert docs

Change link syntax, add an example image, generally clean things up.

docs: Split images for check and radio buttons

Its the same widget, but two images fit better in the gallery,
and will be easier to use as example images in the docs.

linkbutton: Convert docs

Change link syntax, add an example image, generally clean things up.

docs: Improve the togglebutton image

Make it actually show toggles.

wayland: Fix a link

gi-docgen currently can't handle links without namespace
in the Wayland docs.

togglebutton: Convert docs

Change link syntax, add an example image, generally clean things up.

button: Convert docs

Change link syntax, add an example image, generally clean things up.

docs: Fix the annotation for GtkTextView:justification

docs: Fix up the 3-to-4 migration guide

docs: Add backend links to the gdk docs

These are placeholders for when we know how to
link across namespaces.

docs: Add separate toml files for gdk backends

Reusing the same one duplicates the standalone
docs, which doesn't quite seem right.

docs: Brush up the Wayland backend docs

Add some content here.

gdk: Some more tweaks of the docs

docs: Add some links to the pango chapter

docs: Rework the gdk docs

Convert links, make things more concise.

docs: Move GdkEvent docs inline

This is not really worth a chapter of its own.

docs: Improve gsk docs

Convert link formats, add summaries, and make
a few missing things show up in the docs.

docs: Tweak X11 section

Remove unsupported heading anchors.

docs: Tweaks Windows section

Remove unsupported heading anchors.

docs: Tweak Wayland section

Remove unsupported heading anchors.

docs: Tweak a11y section

Convert link syntax.

docs: Tweak running chapter

Remove unsupported heading anchors, fix definition
list use.

docs: Tweak input overview

Remove unsupported heading anchors.

docs: Tweak drawing model overview

Fix link syntax, remove gtk-doc markup.

docs: Tweak css properties section

Fix the use of definition lists.

docs: Tweak the actions overview

Fix use of definition lists, and remove some gtk-doc
markup.

building: Minor tweaks

Remove unsupported anchors from headings.

video: Convert docs

Change link syntax, add an example image, generally clean things up.

glarea: Convert docs

Change link syntax, add an example image, generally clean things up.

drawingarea: Convert docs

Change link syntax, add an example image, generally clean things up.

textview: Convert docs

Change link syntax, add an example image, generally clean things up.

picture: Convert docs

Change link syntax, add an example image, generally clean things up.

scale: Convert docs

Change link syntax, add an example image, generally clean things up.

image: Convert docs

Change link syntax, add an example image, generally clean things up.

separator: Convert docs

Change link syntax and add an example image.

calendar: Convert docs

Change link syntax, add an example image, generally clean things up.

scrollbar: Convert docs

Change link syntax, add an example image, generally clean things up.

infobar: Convert docs

Change link syntax, add an example image, generally clean things up.

docs: Generate the DevHelp file for our namespaces

docs: Update the "Getting Started" page

Drop the Pandoc stuff, add the gi-docgen links, and remove a stray
docbook element.

statusbar: Convert docs

Change link syntax, add an example image, generally clean things up.

infobar: Convert docs

Change link syntax, add an example image, generally clean things up.

progressbar: Convert docs

Change link syntax, add an example image, generally clean
things up.

levelbar: Convert docs

Change link syntax, add an example image, generally
clean things up.

spinner: Convert docs

Change link syntax and add an example image.

aboutdialog: tweak the docs

Add a short summary.

label: Convert docs

Change link syntax, add singl-line summaries,
add missing property docs.

docs: Bring the widget gallery back

We have all the images, lets put them to use.

docs: Remove the last few remaining '+' from GTK

docs: Clean up the first paragraph for various symbols

The documentation engine will use the first paragraph as the summary for
a type or constant.

docs: Show summary in the namespace index

docs: Start porting GtkImage to the new style

docs: Port GtkAboutDialog to the new syntax

We should also clean up the annotations, while we're at it.

build: Quiet down gi-docgen

We are only interested in the warnings and errors.

docs: Fix up the style of the X11 content file

docs: Move detached sections into their own content file

docs: Split GdkDrag and GdkDrop sections

This way we have a section for each class.

docs: Rename GdkTexture section

The name needs to match the class.

docs: Move gdkcairo section to an external file

docs: Move the gtkmain section to its own document

The introspection data does not handle unattached sections like gtk-doc
does, so we need to move what was gtkmain into its own Markdown
document.

docs: Use new link syntax

docs: Begin porting GtkWidget to the new format

doc: Port GtkConstraint to the new format

docs: De-indent GtkRecentInfo.get_applications() return value

Otherwise the four spaces will be treated as a pre-formatted block by
Markdown.

docs: Start porting GtkConstraintLayout to the new doc format

Drop the old gtk-doc'isms, and use the gi-docgen links instead.

docs: Add metadata preamble to GTK's content files

docs: Drop gtk-doc files

We don't use gtk-doc to generate our API reference, so we don't need its
files lying around any more.

Generate GTK API reference(s) with gi-docgen

Stop using gtk-doc, and switch to gi-docgen.

The gi-docgen tool generates API references through the introspection
data, which has various benefits:

 - it does not parse C code
 - it does not generate and run C code to introspect types at build time
 - it does not present a different API from the one we're exporting

Additionally, gi-docgen:

 - does not generate DocBook XML in order to generate HTML
 - does not go through xsltproc
 - parses proper Markdown

Which makes it markedly faster than gtk-doc has ever been.

Add gi-docgen as a subproject

While we're developing gi-docgen it's better to have it as part of our
build.

ci: Update the fedora-docs Docker image

Use the latest base image.